home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
MrmFetchSetValues.z
/
MrmFetchSetValues
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
NNNNAAAAMMMMEEEE
MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss - Fetches the values to be set from
literals stored in UID files
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Mrm/MrmPublic.h>
CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss(
MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy hhhhiiiieeeerrrraaaarrrrcccchhhhyyyy____iiiidddd,
WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
AAAArrrrggggLLLLiiiisssstttt aaaarrrrggggssss,
CCCCaaaarrrrddddiiiinnnnaaaallll nnnnuuuummmm____aaaarrrrggggssss);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessssfunction is similar to XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss,
except that the values to be set are defined by the UIL
named values that are stored in the UID hierarchy.
MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessssfetches the values to be set from literals
stored in UID files.
_h_i_e_r_a_r_c_h_y__i_d
Specifies the ID of the UID hierarchy that
contains the specified literal. The value of
_h_i_e_r_a_r_c_h_y__i_dwas returned in a previous call to
MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
_w_i_d_g_e_t Specifies the widget that is modified.
_a_r_g_s Specifies an argument list that identifies the
widget arguments to be modified as well as the
index (UIL name) of the literal that defines the
value for that argument. The name part of each
argument (_a_r_g_s[_n]._n_a_m_e) must begin with the string
XXXXmmmmNNNN followed by the name that uniquely identifies
this attribute tag. For example, XXXXmmmmNNNNwwwwiiiiddddtttthhhhis the
attribute name associated with the core argument
_w_i_d_t_h. The value part (_a_r_g_s[_n]._v_a_l_u_e) must be a
string that gives the index (UIL name) of the
literal. You must define all literals in UIL as
exported values.
_n_u_m__a_r_g_s Specifies the number of entries in _a_r_g_s.
This function sets the values on a widget, evaluating the
values as public literal resource references resolvable from
a UID hierarchy. Each literal is fetched from the
hierarchy, and its value is modified and converted as
required. This value is then placed in the argument list
and used as the actual value for an XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeesssscall.
MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessssallows a widget to be modified after
Page 1 (printed 10/24/98)
MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhSSSSeeeettttVVVVaaaalllluuuueeeessss((((3333XXXX))))
creation using UID file values the same way creation values
are used in MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt.
As in MMMMrrrrmmmmFFFFeeeettttcccchhhhWWWWiiiiddddggggeeeetttt, each argument whose value can be
evaluated from the UID hierarchy is set in the widget.
Values that are not found or values in which conversion
errors occur are not modified.
Each entry in the argument list identifies an argument to be
modified in the widget. The name part identifies the tag,
which begins with XXXXmmmmNNNN. The value part must be a string
whose value is the index of the literal. Thus, the
following code would modify the label resource of the widget
to have the value of the literal accessed by the index
OOOOKKKK____bbbbuuuuttttttttoooonnnn____llllaaaabbbbeeeellll in the hierarchy:
args[n].name = XmNlabel;
args[n].value = "OK_button_label";
RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
This function returns one of the following status return
constants:
MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS
The function executed successfully.
MMMMrrrrmmmmPPPPAAAARRRRTTTTIIIIAAAALLLL____SSSSUUUUCCCCCCCCEEEESSSSSSSS
At least one literal was successfully fetched.
MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY
The hierarchy ID was invalid.
MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE
The function failed.
RRRREEEELLLLAAAATTTTEEEEDDDD
MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy(3), XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss(3).
Page 2 (printed 10/24/98)